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REPORT GENERATOR FOR A MATHEMATICAL COMPUTING 

ENVIRONMENT 

TECHNICAL FIELD 

The invention relates to a computer program for generating reports from a 
5 mathematical computing environment. 

BACKGROUND 

*i Conventional mathematical tools, such as such as MATLAB™ from Math Works™, 

W Inc., of Natick, Massachusetts, provide a comprehensive technical computing environment 

for performing numerical linear algebraic calculations, solving ordinary differential 
ft 10 equations, analyzing data, and visualizing solutions to complex mathematical formulas by 
rU generating graphs or other images. The computing environment often provides a high-level 

a; 

O programming language that includes a variety of operators and programming commands. 

Engineers use such mathematical tools for a variety of applications such as designing 

•Us? 

LJ complex mechanical and electrical control systems, solving optimization problems and 

n 15 performing statistical analysis. Engineers often use these mathematical tools in conjunction 
with a simulation tool for defining and simulating complex mathematical models. For 
example, manufacturers of mechanical and electronic systems, e.g., cars and integrated 
circuits, use simulation tools to help them design their products. These tools allow designers 
to build and test mathematical models of their systems before building a physical prototype. 
20 Commercial simulation models can be extremely complex and may include thousands of 
interconnected functional blocks. Using a simulation tool, a designer can simulate and 
observe changes in a model over a period of time, typically represented as a series of discrete 
instants, called time steps, such as 1 millisecond, 1 second, 2 hours, etc. Starting from a set 
of initial conditions, specified by the designer, the simulation tool drives the model and 
25 determines the state of the model at various time steps. 

To examine and present information generated by the technical computing 
environment and the simulation tool, designers often create several types of reports. Because 
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commercial models are so complex, the designer can create a myriad of reports, each report 
serving a particular purpose. Typical reports include, for example, a title, the name of the 
author, a brief text description of the report, a legend, and, of course, the actual data drawn 
from the model during simulation. Many of these elements are fixed while others vary over 
time when the simulation data in the model changes. 

A designer, therefore, faces my tradeoffs when designing a report including 
determining the structure of the report, specifying the fixed elements and the varying 
kments of the report and where they should be positioned. This can be particularly difficult 
for varymg"elemerrtsJae£a^ it requires that the designer extract data from the model while 
the simulation is running. OftenTthellesTgnei^ to generate a report for a particular 
state of the model, or time step associated with the simulafi3rir-^H^^ because 
simulations often take many hours to complete. In addition, the designer muSt-sa^iettie 
report in a format convenient to run the same report multiple times and that can be easily 
shared with others. 

Many conventional simulation programs and modeling tools exist that have limited 
ability to generate reports. However, most report generator programs provide only a small 
number of reports, and allow, at most, only certain limited customizations such as changing 
the title of the report and the name of the author. 

SUMMARY OF THE INVENTION 

In general, the invention provides a method and apparatus, including a computer 
program apparatus that provides an object-oriented, component-based report programming 
language by which a designer can easily customize and assemble a report at various levels of 
hierarchical abstraction. 

In one aspect, the invention is directed to a method of generating a report from a 
technical computing environment provided by a mathematical tool. According to the 
method, a set of reporting components is defined that can be assembled to form a report 
template. The reporting components of the report template are processed to perform one or 
more operations within the computing environment. A report is generated as a function of 
the processed reporting components. 
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In another aspect, the invention is directed to a report generator computer program 
that defines a set of reporting components that can be assembled to form a report template 
and processes the reporting components of the report template in order to extract data from a 
model simulator and generate the report. The report generator includes a user interface by 
5 which a designer can hierarchically assemble the reporting elements, which are defined 
according to an object-oriented programming language. The report generator and the 
technical computing environment bi-directionally communicate such that the report generator 
is able to evaluate expressions in the technical computing environment, change initial 
conditions and parameters of the model, and issue commands to the technical computing 
10 environment to advance the current state of a simulated model. In one embodiment, the 
report generator issues commands using an internal programming language of the technical 
computing environment. The report generator can, therefore, control the simulation in order 
\I to produce a report on a state at a particular time step. The report generator includes a 

generation engine that generates an intermediate representation of the report and a 
15 transformation engine that transforms the intermediate representation into an electronic 
document according to a user-selected format. 

The details of various embodiments of the invention are set forth in the 
accompanying drawings and the description below. Other features and advantages of the 
invention will become apparent from the description, the drawings, and the claims. 

20 BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a block diagram providing a high-level overview of a report generator that 
generates a report according to the invention. 

Figure 2 is a flow chart illustrating one embodiment of a process, suitable for 
implementation in a computer program, in which the report generator that operates on a set of 
25 object-oriented reporting elements to interact with a model simulator in order to generate the 
report. 

Figure 3 illustrates one embodiment of a graphical editor displayed by a user interface 
of the report generator by which a report designer can create and maintain report templates. 
Figure 4 illustrates one embodiment of a window displayed by the user interface for 
30 selecting a report template from a list of report templates for editing or printing. 
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Figure 5 illustrates one embodiment of a component creation wizard displayed by the 
uSe^nterface for creating and customizing new report components. 

[e 6 illustrates the graphical editor listing reporting components for another 
example report terhpl^te. 
5 Figure 7 illustrates^eo^responding report produced by the report generator for the 

example report template illustrated inFigurs^ 

Figures 8, 9 and 10 illustrate one embodiment^fla suitable set of report components 
that can be used to define and generate a corresponding report. 

Figure 1 1 illustrates on embodiment of a computer suitable for inipiomenting the 
10 various embodiments of the invention. 

DETAILED DESCRIPTION 

Figure 1 is a block diagram providing a high-level overview of a tool 100 including 
report generator 108 that interacts with technical computing environment 106 and simulator 
122 to generate report 118. Technical computing environment 106 combines numeric 
15 computation, mechanisms for importing and exporting data in a variety of formats, graphic 
display of data, and a high-level programming language. The high-level programming 
language provides flow-control constructs and often includes a variety of operators for 
performing numerical analysis, string manipulation, and even graphical user interface (GUI) 
design. 

20 User 103 interacts with computing environment 106 to perform a wide variety of 

numeric computations such as the creation and manipulation of N-dimensional arrays. For 
example, user 103 can define a square matrix within calculation workspace 106 using a 
single command. The user 103 can directly manipulate the matrix, using one command to 
find its inverse, another command to find its transpose, or another command to learn its 

25 determinant. Computing environment 106 includes a command interpreter that sequentially 
executes the commands entered by user 103. A calculation workspace provided by 
computing environment 106 stores the resultant data as well as component definitions and 
interconnection data that define the current model. 

Simulator 122 interacts with computing environment 106 in order to simulate the 

30 model defined within the calculation workspace. Simulator 122 includes various algorithms 
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and processes for advancing the model and stores state information of the model during the 



As described in detail below, report generator 108 defines a set of report components 
20, each report component 120 having a defined behavior such as inserting data or other 



makes a variety of decisions such as how to format report 118 and what data to include in 
report 118. 

For example, when processed by generation engine 110, each report component 120 
produces a variety of output data such as formatted text, lists, tables, links, and images, or 
controls the flow of generation engine 110 through the reporting process. The output data 
can be predefined or can be extracted from computing environment 106. In addition, a 
component 120 may direct generation engine 1 10 to import external information. For 
example, the model may reference external code files to help with more complex 
calculations. When external code files are available in source form, generation engine 110 
can includes these files into report 118. Generation engine 1 10 can also import external text 
files and images in many other formats. A subset of report components 120 define a 
reporting programming language having flow control constructs such as for-loops, while- 
loops and if-then-else statements. 

Each report template 104 identifies a corresponding set of report components 120 
that, when executed by generation engine 110, generate a corresponding report 118. User 

103 interacts with report generator 108 via user interface 102 and creates a report template 

104 by selecting and assembling components 120 as a hierarchical tree. The user 103 can 
modify the resultant report 1 18 by adding or deleting components 120 from the component 
hierarchy of the corresponding report template 104. In addition, user 103 can define new 
report components or modify the properties of existing report components 120. A report 
template 104 can also refer to other report templates 104. In this manner, output report 1 18 
can combine results from several report templates 104, where there results from a report 
template 104 can depend on the results from prior report templates 104. In one 
implementation, a report template 104 can be recursively defined. 
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When generation engine 110 processes a report template 104, each component 120 
acts independently, but its behavior is influenced by ancestor components in the component 
hierarchy. More specifically, within the hierarchy, each component 120 controls the order 
and manner in which its child components are executed. In one embodiment, report 
components 120 are implemented in an object oriented programming language, such as C++, 
Java, or a proprietary language, and are derived from a common base class. 

Report 1 18 is an electronic document in one of a number of conventional formats 
such as Hypertext Markup web format (HTML), Microsoft Word interchange format (RTF), 
a typesetting format such as TeX, and Adobe Frame Maker interchange format (MIF). 
Generation engine 1 10 produces an intermediate representation 1 14 of a given report in an 
abstract form. Transformation engine 1 12 processes intermediate representation 1 10 to 
produce the report 1 18 in a user-selected document format. 

In one embodiment generation engine 110 produces intermediate representation 114 
as either Standard Generalized Markup Language (SGML) or Extensible Markup Language 
(XML). SGML is a format for organizing and tagging elements of a document. Notably, 
SGML does not specify any particular formatting; rather, it specifies rules for tagging 
elements. These tags can then be interpreted to format elements in different ways. XML is 
derived from SGML and is a markup language especially designed for "web" documents, 
i.e., documents exchanged over the Internet. Style sheets 116 include rules defining how 
transformation engine should transform the intermediate representation 1 14 into report 118. 

Figure 2 is a flow chart illustrating one embodiment of a process 200, suitable for 
implementation in a computer program application, in which report generator 108 (FIG. 1) 
interacts with computing environment 106 and simulator 122 to generate report 118. Report 
generator 108 presents user interface 102 by which user 103 creates one or more report 
templates 104 (block 203). User interface 102 provides a graphical editor for creating and 
editing report templates 104 and a component creation wizard by which for defining new 
components for inclusion in a report template 104. Creation of a report template 104, 
however, is optional and may be skipped if user 103 elects to use a previously defined report 
template 104. 

Upon request, user interface 102 provides a list of all of the report templates 104. In 
order to generate corresponding report 118, user 103 selects one of the report templates 104 
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and instructs generation engine 1 10 to process the selected report template 104 to generate 
report 118 (step 205). 

In response, generation engine 110 loads the selected report template 104 and creates 
an environment for components 120 to operate (block 207). Generation engine 1 10 bi- 
5 directionally communicates with computing environment 106 and issues commands to 
computing environment 106 using the high-level programming language provided by 
computing environment 106. Computing environment 106 interprets and executes the 
commands as if they had been entered directly by user 103. In this manner, reporting 
components 120 can perform a variety of functions within the computing environment 106 
1 o including requesting data from the calculation workspace, evaluating an expression defined 

O 

within the workspace, requesting data from simulator 122 and requesting data from a 

in 



s 
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graphics package. In addition, reporting components 120 can change the state of the 



St simulation model. For example, a reporting component can simulate the model, increment 

jjl the model simulation by one or more time steps, change a parameter or initial condition of 

15 the model or even change the model itself by adding or removing a functional block. 

Reporting components 120 can also execute external processes that change the state of the 
calculation workspace. 

W While processing each component of the selected report template 1 04, generation 

a 

□ engine 110 produces an intermediate representation 1 14 of report 118. This is advantageous 

20 because intermediate representation 1 14 is in a generic, abstract form that can be readily 
converted into a wide variety of document formats (block 207). In one embodiment 
intermediate representation 1 14 is formatted according to a generalized markup language 
such as SGML or XML. 

Transformation engine 1 12 processes intermediate representation 1 14 to produce the 
25 report 1 1 8 in a user-selected document format such as Hypertext Markup web format 

(HTML), Microsoft Word interchange format (RTF), a typesetting language such as TeX, 
and Adobe Frame Maker interchange format (MIF) (block 209). 

Figure 3 illustrates one embodiment of a graphical editor 300 displayed by user 
interface 102 by which user 103 can create and maintain report templates 104. Notably, 
30 editor 300 presents the hierarchy of components 305 defined by a corresponding report 

template. Using editor 300, user 103 can rearrange the order of the components 305, modify 
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properties for the components 305, add new components and, by clicking on button 307, 
generate a report 1 18 for the report template 104 that is currently being edit. 

Figure 4 illustrates one embodiment of a window 400 displayed by user interface 102 
by which user 103 can scroll through a list of report templates 1 14. Upon selecting a report 
template 104 from the list, the designer can elect to edit the report template or can instruct 
generation engine 1 10 to process the selected report template 104 and generate the 
corresponding report 118. In one embodiment, user interface 102 can be bypassed such that 
user 103 can generate reports 118 from a command line interface provided by an operating 
system. 

Figure 5 illustrates one embodiment of a component creation wizard 400 displayed by 
user interface 102 by which user 103 creates and customizes new report components. Using 
wizard 400, user 103 assigns the new component to a component category and define various 
attributes and methods for the component. 

Figure 6 illustrates graphical editor 300 (Figure 3) listing components 605 for an 
example report template 104. In the example report template, the first component of 
components 605 is a high-level report component that specifies output options, including 
output file format. The report component does not insert any visible output into report 118. 
The second component is a paragraph component used to insert formatted text. In the 
example report, the paragraph component inserts the following paragraph: "When peaks. m 
runs in the workspace, the following text is displayed to the command window:". The third 
component causes generation engine 1 10 to evaluate an expression defined within the 
workspace of computing environment 106. The expression, written in the internal 
programming language of computing environment 106, causes computing environment 106 
to output a 3-dimensional graph of an equation. The fourth component of the report template 
instructs generation engine 1 10 to capture a screen snapshot of the generated figure and insert 
the snapshot into report 118. The last component of the report template inserts a table of 
selected that presents various properties for the captured image. Figure 7 illustrates a sample 
report 700 produced by report generator 108 and illustrates the corresponding output of these 
report components including formatted paragraph 701, equation 703, screen snapshot 705 
and table 707. 
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Figures 8, 9 and 10 list one embodiment of a set of report components that can be 
used to define a wide variety of report templates 1 14 for generating corresponding reports. 

Various embodiments have been described of a method and system that provides an 
object-oriented, component-based report programming language by which a designer can 
5 easily customize and assemble a report at various levels of hierarchical abstraction. The 
invention can be implemented in digital electronic circuitry, or in computer hardware, 
firmware, software, or in combinations of them. Apparatus of the invention can be 
implemented in a computer program product tangibly embodied in a machine-readable 
storage device for execution by a programmable processor; and method steps of the invention 

1 o can be performed by a programmable processor executing a program of instructions to 
perform functions of the invention by operating on input data and generating output. The 
invention can be implemented advantageously in one or more computer programs that are 
executable within an operating environment of a programmable system including at least one 
programmable processor (computer) coupled to receive data and instructions from, and to 

15 transmit data and instructions to, a data storage system, at least one input device, and at least 
one output device. 

An example of one such type of computer is shown in Figure 11, which shows a 
block diagram of a programmable processing system (system) 1 100 suitable for 
implementing or performing the apparatus or methods of the invention. As shown in Figure 

20 11, the system 1 100 includes a processor 1112 that in one embodiment belongs to the 
PENTIUM® family of microprocessors manufactured by the Intel Corporation of Santa 
Clara, California. However, it should be understood that the invention can be implemented 
on computers based upon other microprocessors, such as the MIPS® family of 
microprocessors from the Silicon Graphics Corporation, the POWERPC® family of 

25 microprocessors from both the Motorola Corporation and the IBM Corporation, the 

PRECISION ARCHITECTURE® family of microprocessors from the Hewlett-Packard 
Company, the SPARC® family of microprocessors from the Sun Microsystems Corporation, 
or the ALPHA® family of microprocessors from the Compaq Computer Corporation. System 
1100 represents any server, personal computer, laptop or even a battery-powered, pocket- 

30 sized, mobile computer known as a hand-held PC or personal digital assistant (PDA). 



9 



Patent 

AtflPBy Docket No. 04899-035001 

System 1 100 includes system memory 1113 (including read only memory (ROM) 
1114 and random access memory (RAM) 1115, which is connected to the processor 1 1 12 by 
a system data/address bus 1116. ROM 1114 represents any device that is primarily read-only 
including electrically erasable programmable read-only memory (EEPROM), flash memory, 
5 etc. RAM 1115 represents any random access memory such as Synchronous Dynamic 
Random Access Memory. 

Within the system 1 100, input/output bus 1 1 18 is connected to the data/address bus 
1 1 16 via bus controller 1 1 19. In one embodiment, input/output bus 1 1 18 is implemented as a 
standard Peripheral Component Interconnect (PCI) bus. The bus controller 1119 examines all 
10 signals from the processor 1 1 12 to route the signals to the appropriate bus. Signals between 
r i the processor 1112 and the system memory 1 1 1 3 are merely passed through the bus 

fi controller 1119. However, signals from the processor 1112 intended for devices other than 

Li! 

M system memory 1 1 13 are routed onto the input/output bus 1118. 

Ji Various devices are connected to the input/output bus 1118 including hard disk drive 

| 15 1120, floppy drive 1 1 2 1 that is used to read floppy disk 1 1 5 1 , and optical drive 1122, such as 
s a CD-ROM drive that is used to read an optical disk 1 152. The video display 1 124 or other 

rjj kind of display device is connected to the input/output bus 1118 via a video adapter 1 125. 

P Users enter commands and information into the system 1 100 by using a keyboard 1 140 

and/or pointing device, such as a mouse 1 142, which are connected to bus 1 1 18 via 
20 input/output ports 1 128. Other types of pointing devices (not shown in Figure 11) include 
track pads, track balls, joysticks, data gloves, head trackers, and other devices suitable for 
positioning a cursor on the video display 1 124. 

As shown in Figure 1 1, the system 1 100 also includes a modem 1 129. Although 
illustrated in Figure 1 1 as external to the system 1 100, those of ordinary skill in the art will 
25 quickly recognize that the modem 1 129 may also be internal to the system 1 100. The modem 
1 129 is typically used to communicate over wide area networks (not shown), such as the 
global Internet. Modem 1 129 may be connected to a network using either a wired or wireless 
connection. System 1 100 is coupled to remote computer 1 149 via local area network 1 150. 
Software applications 1 136 and data are typically stored via one of the memory 
30 storage devices, which may include the hard disk 1 120, floppy disk 1151, CD-ROM 1 152 
and are copied to RAM 1 1 15 for execution. In one embodiment, however, software 
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applications 1 136 are stored in ROM 1114 and are copied to RAM 1 1 15 for execution or are 
executed directly from ROM 1114. 

In general, the operating system 1 135 executes software applications 1 136 and carries 
out instructions issued by the user. For example, when the user wants to load a software 
application 1 136, the operating system 1 135 interprets the instruction and causes the 
processor 1 1 12 to load software application 1 136 into RAM 1 115 from either the hard disk 
1 120 or the optical disk 1 1 52. Once one of the software applications 1 136 is loaded into the 
RAM 1 1 15, it can be used by the processor 1 1 12. In case of large software applications 1 136, 
processor 1112 loads various portions of program modules into RAM 1 1 1 5 as needed. 

The Basic Input/Output System (BIOS) 1 1 17 for the system 1 100 is stored in ROM 
1114 and is loaded into RAM 1115 upon booting. Those skilled in the art will recognize that 
the BIOS 1 1 17 is a set of basic executable routines that have conventionally helped to 
transfer information between the computing resources within the system 1 100. Operating 
system 1 135 or other software applications 1 136 use these low-level service routines. In one 
embodiment system 1 100 includes a registry (not shown) that is a system database that holds 
configuration information for system 1 100. For example, the Windows® operating system by 
Microsoft Corporation of Redmond, Washington, maintains the registry in two hidden files, 
called USER.DAT and SYSTEM.DAT, located on a permanent storage device such as an 
internal disk. 

The invention has been described in terms of particular embodiments. Other 
embodiments are within the scope of the following claims. For example, the steps of the 
invention can be performed in a different order and still achieve desirable results. This 
application is intended to cover any adaptation or variation of the present invention. It is 
intended that this invention be limited only by the claims and equivalents thereof. 
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